Copyright: Copyright ©


Autogenerate Table of Contents

You can create a list of contents topics automatically.  We will delete the automatic entries we just created during import, then use the Generate Table of Contents feature to choose the topics and the order in which to list them.

1.	Select the three topic names just added to the Contents:  History, Music, and Parks and Recreation, press Delete.

2.	With the cursor in the blank line between Guide and Reference, select Topic|Generate Table of Contents.  The Create Table of Contents dialog box appears.

3.	In the All Topics list, double-click History, then Parks and Recreation to add them to the Topics listing.  (Leave out Music for now; we will add it to a subcontents topic later.)

4.	OK.

The new entries display with jumps in the Contents topic.  If needed, apply the Definition style by selecting Format|Apply Style, select Definition from the Name list box, OK.


Backing Up Your Project

You may build an archive of your help project as frequently as you want.  Backup saves all the component project files in one compressed file.  You may then open a project backup at any time to return to a previously stored version of your database.  Backup files are extremely useful for moving an entire project to another location.

Backup

1.	Select File|Backup.

By default, the backup file has the same name as your database file but with a .FHB extension.  You can change the name but do NOT name it tutorial.fhb to preserve the tutorial database for later use.

2.	OK.  If a backup for the Boulder database has previously been created, select Y to replace it with the new .FHB file.


Building and Troubleshooting Your Project

ForeHelp has a powerful error detection and resolution facility built into the Build process.  Build creates the .RTF and .HPJ files for you.  You can discover and correct errors before compiling your project.

Creating an Error Condition

1.	Go to the Theatre topic.

2.	We will delete the topic although it is connected to a jump.  Select Topic|Delete.

3.	Select Yes  to confirm the deletion.

4.	Move to a topic other than Performing Arts.  (We want to see the error detector locate the jump to the non-existent topic in Performing Arts.)

Building Your Project

1.	Select Project|Build.  No changes are necessary to the Build dialog box.

2.	OK.  The Build Status dialog box displays providing messages as it progresses.

3.	After the error is detected, a message asks if you still wish to compile even though errors were found.  Select No.

Double-click on the error 2002 message.  The cursor will be flashing after Theatre in the Performing Arts topic for us to correct.

5.	Select the Theatre line of text, press Delete.


Compiling Your Project

Compile is the process that uses the .HPJ and .RTF files created in the Build process to create the final .HLP file.  Build and Compile are often run together.

1.	Select Project|Build.

2.	OK to build and compile the project.  The Build Status dialog box appears.

If no errors are detected, Compile begins after Build completes.  Messages tell you that the Compile was successful with no errors.

3.	Close the Build Status window.


Contents


Creating Background Wallpaper

In the banner (non-scrolling area) at the top of the topic, there is a large bitmap used as wallpaper behind text.  You can also use background wallpaper in the text area. For details on how to use your own background wallpaper, refer to the ForeHelp User’s Guide.


Creating Browse Sequences

Browse sequences allow the reader to scan multiple related topics in a set sequence, moving forward or backward.  We will put the topics relating to Performing Arts together in a browse sequence.  A topic can only belong to one sequence.

Naming a New Sequence

1.	Select Project|Browse Sequences.  The Project Browse Sequences dialog box appears.

2.	To name a new sequence, select the Sequences button.  The Sequences dialog box appears.

3.	Select New.  The Enter New Browse Sequence Name dialog box appears.

4.	Type performing arts, and press Enter.

5.	Select Done.  The Project Browse Sequences dialog reappears.

Assigning Topics to a Browse Sequence

1.	In the Project Browse Sequences dialog box, click the arrow to the right of the Sequence text box to display the drop down list.

2.	Select performing arts.

3.	Double click each of the Performing Arts topics in the All Topics list box, in the order you want them.  Double click:

Performing Arts - Dance - Music - Theatre

Notice that as you add a topic, it becomes grayed in the All Topics list.  You may select it later to add it to a different sequence, but you will be subtracting it from its current sequence.

4.	OK.

Test your browse sequence by accessing Test mode (F10).  Go to Contents, then jump to Performing Arts.  ForeHelp automatically added the browse buttons macro to your project, and only the appropriate button(s) are enabled.  Click the buttons to move forward and backward in the sequence.

5.	Close the test window.


Creating Jumps

Manually Creating One Jump

There are several ways to create jump hotspots.  To manually create one jump (from the Contents topic to the new Performing Arts topic):

1.	Alt+C  to go to the Contents topic.

2.	Place your cursor in the blank line below Parks and Recreation, and type Performing Arts.

3.	Highlight Performing Arts, and select Text|Make Jump.

4.	In the Make Jump dialog box, double-click on Performing Arts in the Targets list box.

Ctrl+Click on Performing Arts to test the jump.

Our new Performing Arts topic will contain another list of topic jumps to the specific performing arts topics.  We will use two methods to create these jumps for new and existing topics.

Creating a Jump and the Destination Topic Simultaneously

1.	Type Dance in the text area of the Performing Arts topic.

2.	Highlight Dance, and select Text|Make Jump.

3.	Click the New Topic button.  The Topic Properties dialog box displays.

4.	OK to accept the default settings.  The Dance topic displays in the ForeHelp window.

5.	Test the new jump/topic:

Press Alt+B to return to Performing Arts.

Test your jump (Control+Click on Dance).

Return to Performing Arts.

Creating Multiple Jumps and Topics Simultaneously

Another great feature of ForeHelp is the ability to select a range of paragraphs and make multiple jumps/popups and topics.

1.	Place your cursor at the end of Dance, and press Enter.

2.	On successive lines (don’t worry about spacing, we’ll change it later), type Miscellaneous, Music, and Theatre.

3.	Highlight all text in the three lines containing your new entries, and select Text|Make Multiple Jumps.

The jumps and their destination topics are created.  The Music topic was imported in the RTF file.  A link is automatically made to a topic when it already exists.  The other new topics contain only the title in the banner.


Creating Popups

You have the same options for creating popups as for creating jumps: making a single popup link, creating a popup link and a destination topic simultaneously, and making multiple popups from a list of topic names.  A common use for popups is to define a term.  We will make a popup topic for the term describing the Flatirons.

1.	Alt+G to go to the History topic.

2.	Highlight Flatirons at the end of the first sentence.

3.	Select Text|Make Popup.

4.	Click the New Topic button.

Note that in the Topic Properties dialog box, the Banner option is automatically deselected.  If a popup topic has a banner, only the banner area displays in WinHelp.

5.	OK to accept the defaults and move to the new topic.

6.	Apply the Subheading style.

7.	Enter to begin a new paragraph.

8.	Apply the Base style.

9.	Type: The Flatirons are a series of dramatic, sloping red rock slab mountains located on the west side of Boulder.

10.	Alt+B to return to the History topic.


Creating Secondary Windows

You may want specific jumps to bring up the destination topic in a separate window from the main working window.  The user can then keep the second window available for reference while working in the main window.  We will create a secondary window for Area Attractions.

Defining a Window Class

1.	Select Project|Window Classes.  The Window Classes dialog box displays.

2.	Select New to add a window class name.  The Enter New Window Class Name dialog box appears.

3.	Type attract as the new name, OK.

4.	Click the Caption check box, click in the text box, and type Area Attractions.  This text will display in the secondary window's title bar.

5.	A representation of the window relative to the screen displays in the Sample box.  Drag the edges so that the window is wider than the default box, then click in the title bar representation area to drag the window so that it’s centered in the screen.

6.	Click the Banner box and then the Change button.  The Color dialog box appears.  Select a color for the banner area of the secondary window, OK to close the Color dialog box.

7.	OK to close the Window Classes dialog box.

Using a Window Class for a Jump

1.	Alt+C to go to the Contents topic.

2.	Click in the Area Attractions hotspot text, select Text|Edit Jump.

3.	Select attract in the Window list box, OK.

Testing the Window Class

1.	Select F10 to access Test Mode.

2.	Click on the Area Attractions jump.  A secondary window appears on top of your main window containing the Area Attractions topic.

3.	Close the secondary window and the Test window.  Your ForeHelp window reappears.


Creating a New Topic

There are several ways to create a new topic.  You can use the Topic|Copy Topic command to create a new topic using the same formats, text, macros, and topic properties as an existing topic.  However, we will begin by creating a new topic from scratch.

To Manually Create a New Topic

1.	Select Topic|New.  The Topic Properties dialog box appears.

2.	Enter Performing Arts as the Topic Title.

The options selected are the defaults of the current topic.  No changes are necessary.

3.	OK.

The Performing Arts topic displays in your ForeHelp window with the topic title copied to the banner.


Creating and Using Macros

You can execute macros in three ways:  1) as a Project Macro which runs when the project is opened (Project|Macros);  2) as a Topic Macro which runs when a topic is accessed (Topic|Macros); and 3) as a Hotspot Macro which runs when clicked on (Text|Make Macro).  We will place a macro hotspot on a Close button .SHG file in the banner of the Area Attractions topic.

1.	Alt+G to go to the Area Attractions topic.

2.	Click to the right of the last button in the banner, press the spacebar, select Text|Insert Picture to insert close.bmp.

3.	Double click the new picture to activate the Sheg Editor, draw your hotspot rectangle to cover the entire bitmap, select Text|Make Macro.  The macro editor appears.

4.	Click the down arrow to the right of the Command List box to access the drop-down list box of available macro commands.

5.	Scroll down the list and click on the CloseWindow macro.  The macro syntax for the CloseWindow macro appears in the Command List box.

6.	In the Window Name edit box in the Parameters section, type attract to indicate the window class name to close.  Press Enter or the Insert button.

7.	Click the Add button to transfer your new macro to the Current Macro Commands list box, OK.

Consult the ForeHelp help file or User’s Guide for definitions of all WinHelp macros.

8.	Click outside the .SHG file and save it.  If a file already exists, click Yes to overwrite it.

9.	Test your macro by accessing Test mode (F10), click the Contents button, click the Area Attractions jump, and click the Close button.  Close the Test mode window.


Editing .SHG Files

Viewing and Changing Attributes of Pictures

1.	Click the picture of the Colorado map to select it.  The picture name and its path appear in the status bar on the bottom right of the screen.

2.	Select Text|Edit Picture.

You can now insert a different picture in place of the selected picture, change the placement, or change storage methods.

3.	Cancel.

Changing/Removing Hotspots on a .SHG File

1.	Double click the .SHG picture to reenter the Sheg Editor.

2.	Click on the Boulder hotspot.  Handles appear around the hotspot.

You may use the handles to shape the hotspot area, or you may click inside the hotspot and drag the box to another location.  Select Text|Edit Popup to change the destination topic or change attributes.  Don't do it now, but you would press Remove to delete the hotspot altogether. Cancel.

3.	Click outside the map to exit the Sheg Editor.


Editing Text

Applying a Style

1.	Select the entire list of the topic names in the Performing Arts topic.

2.	Apply the Definition style from the drop-down list on the format bar,

or

select Format|Apply Style, and choose the Definition style from the Name list, OK.

Using Bullets and Auto Numbering

There are several bullet and numbering formats available for lists of information.  We will place bullets in front of each entry in the Performing Arts listing of subtopics.

1.	Select the entire list of the topic names.

2.	Select Text|Insert Bullets...  The Bullets and Numbering dialog box appears.

3.	If the Bullet option is not selected, select it now.  Click the desired default bullet picture in the list box, OK.

To Add Your Own Bullet Bitmaps

You can easily use one of your own bullet bitmap pictures by clicking the Add button, locating the .BMP or .WMF file you wish to use in the Add Bullet Picture dialog box, and giving the picture a name in the Bullet Name edit box, OK.  The new bullet name will appear in the list of available bullet names.


Editing and Removing Hotspots and Topics

Removing a Topic

1.	To remove the Miscellaneous topic, Alt+G to go to that topic.

2.	Select Topic|Delete.

3.	Enter to confirm the deletion.  You now have a jump to a non-existent topic from the Performing Arts topic.

Editing a Jump (Hotspot)

1.	Alt+G to go to Performing Arts.

2.	Click in the Miscellaneous text.

2.	Select Text|Edit Jump.

You could then choose to redirect the jump to another topic, select a different Window Class, remove, or hide the Jump.

Deleting a Jump (Hotspot)

1.	From the Edit Jump dialog box, select Remove.  The hotspot is removed from the text.  Delete the Miscellaneous line in the Performing Arts topic.

or

To remove the hotspot and the hotspot text together, select the hotspot text, and press Delete.


Generating a Manual

You can create a special RTF file from your ForeHelp database with your choice of features.  Import the RTF file into a word processor to finalize formatting and to print.

1.	Select Project|Generate Manual.  The Generate Manual dialog box appears.

2.	Click the RTF File button to access the Select or Create RTF File dialog box.  Type manual.rtf in the File Name edit box, OK.

Do not name this RTF file the same as your database name because ForeHelp generates another RTF file using your database name during build.

3.	Double-click any topics in the All Topics list that you want to include in your manual.  Order the topics by adding them in the order you want, or click Alphabetize, or click a topic name and move it Up or Down appropriately.

4.	In the Break on Styles list, select Heading to create hard page breaks for each major heading, OK.  The Generate Manual Status window appears to inform you of the progress and completion.  Close.

To see the results, or to format and print your manual, open the new RTF file in a word processor.


HB: Close Book
Closed Book

Windows Help Browser Window

Clicking on a topic without a + sign closes the tree.


HB: Close Book and Check Mark
Close Book and Check Mark

Windows Help Browser Window

Clicking on a topic without a + sign closes the tree.  Each topic selected for printing has a check mark in front of it.


HB: Close Book and Disconnected Topic
Close Book and Orphan Topic

Windows Help Browser Window

Disconnected topics indicate that no links exist in the help file to that topic.  You can turn off the Show Orphans option in the View menu.  Clicking on a topic without a + sign closes the tree.


HB: Closed Book and Popup
Closed Book and Popup

Windows Help Browser Window

The topics marked with a single perpendicular bar indicate the topic will appear in a popup window.  Clicking on a topic without a + sign closes the tree.


HB: Match
Match

Help Browser Dialog Box

You can select to search for your string in whole words only, and you can choose whether or not to find matches with exact case only.  If you check Whole Words Only, and you search for "cat", the search will find "cat" but not "catalog".  If you check the Case box, if you search for Cat, the search will find "Cat" but not "cat" or "CAT".


HB: Open Book & Highlight
Open Book & Highlight

Windows Help Browser Window

The open book and highlight indicates the Help topic currently displayed in the Help window.


HB: Options
Options

Windows Help Browser Window

The Options in this menu are:

Font	Change the font in which the text in the Windows Help Browser window is displayed.

Print Selected Topics	Prints the topics you have marked in the Windows Help Browser Window.

Print All Topics	Prints all the topics in the Help file


HB: Plus
Plus Sign

Windows Help Browser Window

Clicking on a topic with a + sign expands the display to show all the child topics.


HB: Plus and Check Mark
Plus Sign and Check Mark

Windows Help Browser Window

Clicking on a topic without a + sign closes the tree.  Each topic selected for printing has a check mark in front of it.


HB: Plus and Double Arrow
Plus Sign and Double Arrow

Windows Help Browser Window

The double arrow indicates this topic is in a browse sequence.  Clicking on a topic with a + sign displays all the linked topics.


HB: Search For
Search For

Help Browser Dialog Box

Enter the text string for which you wish to search the entire .HLP file.  The drop down list displays past search text strings.


HB: Search In
Search In

Help Browser Dialog Box

You can select to conduct your search in Topic Titles Only, or throughout all the text the .HLP file.


HB: Search Results
Search Results Dialog Box

The Topics found box displays the number of times the text string was found and the topic names containing the string.  The list is sorted with the most matches at the top.  When you select a topic in the list, the topic text displays below with the first match highlighted.  Use the Next and Previous buttons to move forward and backward through the matches.  Selecting the Goto Topic button closes the Search Results dialog box and displays the selected topic in the WinHelp window.  Selecting Print Topic closes the dialog box and prints the selected topic.


HB: View
View

Windows Help Browser Window

The options in this menu are:

Tidy	Cleans up the display by closing all branches except the one containing the current topic.

Show Browse Links	Selects whether or not marks for browse sequence topics are displayed.

Show Hot Links	Selects whether or not marks for jump topics are displayed.

Show Popup Links	Selects whether or not marks for popup topics are displayed.

Show Orphans	Displays topics not referenced by other topics in the help file.


Help Browser

This topic contains the following sections:

To Add the Help Browser Features to Your .HLP Files

To Access the Windows Help Browser Window

To Print Multiple Topics

To Find a Text String in the Help File

The Help Browser 2 adds two new buttons to the WinHelp button bar: Browse and Find text.  The Help Browser gives your .HLP file readers a browser window that displays the organization of your help file in a collapsible and expandable hierarchical outline.  Your readers can navigate through the help file without getting lost in layers of topics.  Your readers can mark any and all topics in the browser window to print multiple topics without the WinHelp restriction of printing one topic at a time.  Help Browser lets your readers search for any text string in the entire help project in addition to the structured keyword search.

To order, click on the Order Form button, print the ForeFront Order Form, complete it, and send to ForeFront.

Note: The Help Browser buttons do not appear in ForeHelp Test Mode.

To Add the Help Browser Features to Your .HLP Files

1.	Install the add-on Help Browser for ForeHelp software.

2.	Create the project macros described in the Help Browser User Manual.

3.	When you are ready to create the Help Browser database for your .HLP file, check the Help Browser option in the ForeHelp Build dialog box.  This option only appears on the Build dialog box when you have installed Help Browser.

Help Browser creates a database file (.HBR) for your .HLP file and adds a Browse button and Find Text button to the WinHelp button bar.  The database is approximately 10% of the size of the .HLP file.

Important:  To install Help Browser with your .HLP file, copy the Help Browser DLL into the \WINDOWS\SYSTEM directory and the .HBR file in the same directory as your .HLP file.

To Access the Windows Help Browser Window

Click the Browse button in the WinHelp button bar to access the Windows Help Browser window.

To Print Multiple Topics

Click the Browse button in the WinHelp button bar to access the Windows Help Browser window.

To Find a Text String in the Help File

Click the Find Text button in the WinHelp button bar to access The Help Browser dialog box.


Help Browser Window

Clicking the Browse button on the WinHelp button bar in an .HLP file that uses the Help Browser displays the Windows Help Browser window.  Click the appropriate area of the graphic below to learn what the symbols mean.

To Expand the Tree of a Particular Topic, click the + icon.

To Close a Topic's Tree, click on a topic without a + sign.

To Navigate to a Topic in the Help Window, double-click the topic name.

To Mark a Topic for Print, press Shift+Click on the topic name.  You can only print topics marked in the visible window.

To Mark a Range of Topics for Print, Shift+drag left mouse button along the range of names.


Help Browser Dialog Box

To access the Help Browser dialog box to search for a text string, click the Find Text button in the WinHelp button bar in an .HLP file that has Help Browser capabilities.  Enter a text string in the Search For field and select any other desired options.  The Search Results screen displays.


Inserting Hotspots on Pictures

There are two ways to place hypertext jumps, popups, and macros on pictures.  In our first example, we will place jumps on the entire button pictures to go to the appropriate targets.  In the second example, we will use a technique to create multiple hotspots on one picture.

To Make a Jump from the Entire Picture

1.	Click on the first button picture, and press Shift+Right Arrow to highlight the picture, just as if it were text.

2.	To make the area a jump hotspot, select Text|Make Jump.

3.	Select target-a, OK.

4.	Repeat steps 1 - 3 for the two additional pictures, selecting the appropriate jump targets.

Test the jumps using test mode (F10).  Close the test window when you are finished.

To Make Multiple Hotspots on a Picture

We will insert a picture of a Colorado map in the History topic.  We will make a hotspot on only a portion of the picture.  You could make additional hotspots on the same picture, provided you are not running the demo version of ForeHelp, where we have reached the 10 topic limit for the project.

1.	Alt+G to go to the History topic.

2.	Place your cursor at the end of the topic text, and press Enter.

3.	Select Text|Insert Picture, and insert colorado.bmp.

4.	Double-click on the picture.

Note the rectangle surrounding your graphic to let you know you have accessed the Sheg Editor.  The Sheg editor lets you draw hotspot areas on a graphic and creates a .SHG (segmented hypergraphic) file when you exit.

5.	Drag your cursor around the Boulder area on the map to create a rectangular hotspot of the area.

6.	Select Text|Make Popup, and select the New Topic button.

7.	Type Boulder as the Topic Name, OK.

At this point, you could draw additional hotspots on the graphic.

8.	Click outside the picture to exit the Sheg Editor.  The Save SHG File dialog box appears.

9.	OK to accept the default picture file colorado.shg.  If a file of the same name already exists, type Y to overwrite it.

To Complete the New Topic and Test

1.	Ctrl+Click on Boulder to go to the new topic.

2.	Apply the Subheading style.

3.	Place your cursor at the end of the text and press Enter.

4.	Apply the Base style from the drop-down style list on the format bar.

5.	Type Boulder is a popular city and county located along the Front Range of the Rocky Mountains just Northwest of Denver.

6.	Alt+B to go back to the History topic.

7.	Test your popup with F10.  Close the Test window.


Inserting RTF Files

In order to save typing time, we will insert an .RTF file containing existing topics and styles.  You can do this with any existing files or help projects saved in .RTF format.  If you want to see the formatting of our RTF file, open bldr-txt.rtf in a word processor.

1.	Place your cursor on the blank line between Guide and Reference.

2.	Select Text|Insert File.

3.	Click the file name bldr-txt.rtf in the tutorial directory, OK.  The RTF Import Options dialog appears.

General Options

5.	Clear Create Topic at Page Break.

When you deselect this option, Interpret as Help Format File is automatically cleared.  Rather than creating a new topic at each hard page break, we want to create a new topic each time the Heading style is encountered.

Common Named Styles

6.	Select Use RTF File Styles.

The ForeHelp database has some of the same style names that are used in the incoming .RTF file.  We are choosing to have the RTF style characteristics override the ForeHelp styles of the same name.

Style Options

7.	In the Styles: list, click in the Heading box so that an x displays beside Heading, if it is not already checked.

8.	Click the Create New Topic box so that an x displays.

A new topic will be created whenever the Heading style is encountered.

9.	Click Add to Table of Contents so that an x displays.

An entry for each topic will be added to the cursor location in the current topic to create a table of contents complete with jumps to the topics.

10.	Click Add Banner so that an x displays.

Each new topic will have a banner (non-scrolling area) with the Heading style text as the title in the banner.

11.	OK.

The Import Status window reports the progress of the import. When the import has completed, close the Import status box.  The topic headings with jumps established are listed at the cursor location.

12.	While the list of headings is still highlighted, apply the Definition style by clicking the down arrow for the drop-down list box at the far right on the format bar, and selecting Definition.

To see the new list of all topics, select Alt+G to display the Goto dialog box.  Cancel.


Inserting Targets

Targets are used to enable the reader to jump to a specific location in the middle of a long topic, rather than jumping to the top of a topic, as a normal jump does.  In the Area Attractions topic, we will insert buttons in the banner which will let the user click a letter to quickly jump to the appropriate location in the topic.  We must first assign the targets to which these jumps can be made.

1.	Alt+G to go to Area Attractions.

2.	Place the cursor to the left of the first text entry (Boulder Arts Center), and select Text|Insert Target.

3.	In the Context String box, type target-a.  Notice the hyphen is replaced with an underscore to convert it to a legal context string.  OK.

4.	Scroll down in the topic and place your cursor at the second target location, to the left of Gillaspie House, select Text|Insert Target, type target-g, OK.

5.	Scroll down in the topic and place your cursor at the last target location, to the left of Rockies Brewing Company, select Text|Insert Target, type target-r, OK.


Inserting a Picture

We will insert three bitmap pictures of buttons which the reader can click to go to the targets within the Area Attractions topic.

1.	Place your cursor just to the right of the banner text.

2.	Select Text|Insert Picture.

3.	In the tutorial directory, select the picture file a-f.bmp.  Note that the picture appears in the sample box. OK.  The button picture appears in the banner.

4.	Press the spacebar once to separate the pictures, and insert the picture g-q.bmp.

5.	Press the spacebar once, and insert the picture file r-z.bmp.


Introduction

Help Tutorial vs. Written Tutorial

If you prefer to use the tutorial on-line, proceed through this tutorial using the browse buttons (>> and <<) to advance through the topics in sequential order.  Click the On Top button if you want the tutorial window to stay on top.  To see or edit on parts of the screen behind the tutorial window, move the window while you perform the required action.  Be sure you click in the appropriate window (ForeHelp or Tutorial Help) before navigating.

If you would rather follow a printed tutorial, see Section 1 in the ForeHelp User's Guide if you have the full product, or if you have the demo software, double-click the Microsoft Write icon installed with ForeHelp in the program group, and print the tutorial file.

Purpose

The ForeHelp Tutorial is designed to guide you through common help authoring activities you will use when developing your help project from start to finish.

Assumptions

This tutorial assumes you are familiar with Help terminology and processes, as well as the Windows interface.

If you are not familiar with Help project terms and procedures, there are some overview sections in ForeHelp's Help application that will introduce you.  From the ForeHelp application, select Help.  Select Contents.  (This process of making sequential selections will hereafter be shown as:  Select Help|Contents.)

In the Introduction section of the Help file, select What is ForeHelp, and/or ForeHelp Concepts and Terms.

Note:  In the following instructions, each procedure mainly uses menu selections to choose a feature.  You can also access many features by keystroke accelerators (found in the menu).  Each feature can also be accessed by its button on the toolbar.  See File|Preferences to add buttons to the toolbar.


Moving Among Topics

You can move among topics using hypertext links in the same way you will in the final help file.  ForeHelp provides a few other methods.  All the following features have toolbar buttons you may want to use. Select File|Preferences to add the desired buttons.  Try the following:

Jumps and Popups

To move to the destination topic of a jump or popup, hold the Control key and click on the hotspot when the hand appears over it.

Goto

Press Alt+G or Topic|Goto to access the Goto dialog box.  Double click the topic where you wish to move.

Back

Press Alt+B, or Topic|Back, to go back to the previous topic.  Repeated Back commands move backwards through the last 40 topics you have visited.

Contents

Press Alt+C, or Topic|Contents, to go to the Contents topic.

History

Press Alt+T, or Topic|History, to bring up the History window listing the last 40 topics you have visited, in reverse order.  Double click on any topic listed to move to that topic.  Close the History window when you are through and no longer want it to display.


Opening a Backup Project

The tutorial is stored as a backup file so that you can use the original files repeatedly.  A backup file is a compressed archive of all files in a help project.

If this is the very first time you have run ForeHelp, the New/Open/Open as Template dialog box automatically appears; otherwise select File|New Open...:

To Open a Backup File

1.	In the List Files of Type box, select ForeHelp Backup File.

2.	Select the Directory and Drive of the tutorial directory (by default, \forehelp\tutorial).

3.	In the File Name list box, double click tutorial.fhb to open the backup.

4.	The Expand Project Backup dialog box appears, select OK to accept the default settings.

If a ForeHelp message box appears informing you of existing files of the same name, select All.  The ForeHelp database, named Boulder, opens with the Contents topic displayed.

To View the Topic List

1.	Select Topic|Goto to see the list of the topic names in this project (there are just two).  Cancel.


Printing Topics

1.	Select File|Print Topics.  The Print Topics dialog box appears.

2.	Select one, several, or all topics to be printed.

3.	Select any print options you want using the standard Windows print dialog boxes.

4.	OK.


Running Your Final Help Project

When Compile completes successfully, you have a final .HLP file ready to run.

To run your new help file:

1.	Select Project|WinHelp.

Your final help project will appear in the WinHelp application.

Your final help project is complete!  When you close the Help window, your ForeHelp screen will still be available.


Saving Your Help Database

It is a good idea to save your work occasionally as you progress with the development of your ForeHelp database.  By default, you are working on a copy of the database project.  When you choose to save your project, the temporary copy is written to the original database.  In the event of a system crash, you will be able to open the original database at the point it was last saved.  You can also return to the database version when you last saved or closed ForeHelp by selecting File|Revert Project.

To Save Your Latest Changes

1.	Select File|Save Project.


Search results
Search Results Dialog Box

Completing the Help Browser text find dialog box and choosing OK displays the Search Results dialog box.  This dialog box lists the topics where the text string was found throughout the .HLP file.


See Also: Help Browser
See Also

Help Browser

Help Browser Window

Help Browser Dialog Box

Search Results


Setting Preferences

Access the Preferences dialog box to change your screen display’s attributes

1.	Select File|Preferences.

To Change Hotspot Colors

2.	In the Override WinHelp Colors section, select Change for the appropriate hotspot, and you will see the standard Windows Color dialog box.  Make color changes as desired, OK.

The default color for all hotspots is green.  Changed hotspot colors are saved in your WIN.INI file and affect only help files displayed on your own system.

To Change Screen Attributes

3.	Click Show attributes to toggle them on or off.

By deselecting most options, you increase the text display space.

To Customize Your Toolbar

4.	In the Toolbar section, click the Large Buttons box to toggle between a set of toolbar buttons with text (larger buttons and more descriptive) and toolbar buttons without text.

5.	Click the Toolbar button to display the list of available buttons.  Double-click the desired button to select and deselect buttons to display on the toolbar.

Black buttons indicate they are not currently used on the toolbar; gray buttons indicate they are on the toolbar.

6.	Close.

7.	OK.


Starting ForeHelp

Either:

Double-click on the ForeHelp icon (if you specified a Program Group during Installation),

or

1.	From the Program Manager, select File|Run.

2.	Enter the full pathname for FOREHELP.EXE, OK.


Starting a New Project

We will not be starting a new project from scratch at this time, but you may want to refer back to this section when you begin your own new projects.

New/Open/Open as Template

When you start ForeHelp, the last project you were working on will appear in the ForeHelp window by default.  You can change the default through File|Preferences.

1.	After starting ForeHelp, select File|New/Open...

2.	In the File Name box, type in a name for a new project, or select an existing name to open a file.

ForeHelp maintains your help project in a series of database files named with .DBA through .DBG extensions.  All these files are necessary for the project.  The checked Edit copy box indicates you will be working on a copy of your project for safety.  The original database is retained until you select File|Save or close the project.

3.	OK.

Project Properties

The Project Properties dialog box automatically appears after naming a new project.  The only required field is the Project Title (which is the text displayed in the title bar in Test mode and in your final project).  Select Project|Properties to make any changes to this dialog in the future.

1.	Type your desired title in the Project Title box.

2.	OK.

Topic Properties

The original topic in any project is the Contents topic, although you may change the name and/or designate any topic as the Contents topic later.  Generally, the Contents topic includes a listing of major topic areas in your project and is the topic used by the Contents button in the final help project.

1.	Check the Banner box when you wish to establish a non-scrolling area at the top of a topic.

2.	Check Copy Title to Keyword if you want the Topic Title to automatically be a keyword for the topic.

3.	Check Copy Title to Topic when you want the Topic Title to be reflected in the topic text as either:  a) the first line of text if you do not create a Banner, or b) the banner text if you do create a Banner.

The Context String is used by jumps and popups to the topic.  The Context Number and Context Map File fields are only used for organizing access to the topic for context sensitive help or external programs.

4.	OK.

You may return to any topic's Topic Properties dialog box to add or change any attributes by selecting Topic|Properties when the topic is displayed.

You're ready to start your new project!


Testing Your Project

You have already seen how Help-like ForeHelp's editing mode is.  To instantly see your help project exactly like the compiled .HLP file, use the Test Mode.

1.	Select Project|Test to activate the Test Window.

2.	To see the popup you just created, click on the Flatirons hotspot when the hand appears.  The popup displays just like the final help project.  Click again to close the popup.

Take time now to use the jumps you have created.  Use the Contents and Back buttons and jumps and popups just as you would in Help.

3.	To exit Test mode, close the Test window.  Your ForeHelp window reappears.


Tutorial Table of Contents

ForeHelp Tutorial
Table of Contents

Introduction

Starting ForeHelp

Opening a Backup Project

Creating Background Wallpaper

Setting Preferences

Inserting RTF Files

Viewing and Editing Paragraph Styles

Moving Among Topics

Autogenerate Table of Contents

Creating a New Topic

Creating Jumps

Editing Text

Creating Popups

Testing Your Project

Editing and Removing Hotspots and Topics

Saving Your Help Database

Inserting Targets

Inserting a Picture

Inserting Hotspots on Pictures

Editing .SHG Files

Creating Secondary Windows

Creating and Using Macros

Creating Browse Sequences

Using Keywords

Using Find to Create Hotspots and Keywords

Backing Up Your Project

Printing Topics

Generating a Manual

Viewing Your Project Structure and Relationships

Building and Troubleshooting Your Project

Compiling Your Project

Running Your Final Help Project

Starting a New Project


Using Find to Create Hotspots and Keywords

ForeHelp's advanced Find and Replace feature, in addition to providing standard search and replace features, lets you search for any string and turn the string into a popup, jump, or macro hotspot, or keyword.  You can choose to search the current topic, the current browse sequence, or all topics.  We will use the Find feature to turn every occurrence of the word Flatiron into a popup to the Flatiron topic.

Setting Up Find

1.	Select Tools|Find.

2.	Type Flatirons in the Search For box.

3.	Click on the If Found box to display the drop-down list.

4.	Select Make Popup.

5.	Select All Topics in the Look Where box.

6.	OK.  The Make Popup dialog box displays.

7.	In the Make Popup dialog box, click Flatirons as the target, OK.

Responding to Find Occurrences

1.	A Text Find dialog box displays each time the search string is found.  Complete the Find by selecting appropriate response to each occurrence.  You may want to Skip the first two occurrences because they are in the popup topic.


Using Keywords

Keywords allow the reader to locate information using the Search dialog box and the keywords and phrases you assign to appropriate topics.  Topic keywords take the reader to the top of the topic.  Text keywords take the reader to a specific location within a topic.

Creating Topic Keywords

1.	Go to your History topic.

2.	To create keywords associated with the History topic, select Topic|Keywords.  The Topic Keywords dialog box appears.  The current topic is displayed in the Topic box.

3.	To create keywords associated with this topic, type Rocky Mountains in the All Keywords edit box, and press Enter.

4.	Continue adding keywords for the History topic.  Add:

Native Americans - Flatirons

5.	To add keywords to another topic, select the Parks and Recreation topic in the Topic box.

6.	Add keywords to the Parks and Recreation topic as follows:

Double click Boulder and Rocky Mountains in the existing list to add an existing keyword, also add camping.

7.	OK.

Text Keywords

1.	Go to the Area Attractions topic, then Control+Click the R-Z button in the banner.

2.	To place a text keyword at Rocky Mountains in the Rockies Brewery description, place your cursor at the R in Rocky Mountains, and select Text|Insert Text Keyword.

3.	Double-click Rocky Mountains in the Keyword in Text dialog.  If text detail is not turned on, in File|Preferences, select Text Detail to see a key icon appear at the location of the text keyword.

Using Keyword Search

You can use the Search option to access Keyword Search in Edit mode, Test mode or the final help project.

1.	Select Topic|Search.  The Search dialog box displays.

All keywords display in alphabetical order in the top list box.

2.	Double-click Rocky Mountains in the top list box to display a listing of topics containing that keyword.

3.	In the bottom list box, double-click Area Attractions to see the keyword in context.


Viewing Your Project Structure and Relationships

Navigator

The Navigator is a graphical presentation tool you can use to view topics and the jumps and popups coming into them and out of them, as well as their location in a browse sequence.

1.	Go to your Performing Arts topic.

2.	Select Tools|Navigator or the Navigator icon on the tool bar.

Notice your current topic (Performing Arts) is in the center and is underlined.  Topics to the left are jumping or popping up to the topic; topics to the right are the jumps and popups from the topic.  The topic above and below the center topic show the surrounding topics in a browse sequence.

The underlined topic is always in the center and shows its relationships.  To change the center topic, double click on the desired topic.

The highlighted topic is the current topic in the main window.  To change the topic in the main window topic, click on the glasses of the desired topic.

If you have navigated away from the topic in the main window and want to return to it, click the second icon in Navigator’s toolbar or select File|Navigate to Main Window Topic.

Right-click on a topic name to expand the number of levels along that topic's path.

3.	To leave Navigator, close the Navigator window.

Grapher

The Grapher displays your project in a hierarchical outline form.  You can see which topics are subordinate to others.  If a box is gray, it means the topic is used in at least one other location, and you can find its link structure elsewhere in the Grapher.  If a box is black, it means there are more levels beneath it that can still be expanded.  In File|Preferences, you can set the default number of levels that Grapher displays and the number of graphs that it remembers (History) when you use the Back toolbar icon.

1.	Select Tools|Grapher or the Grapher icon on the tool bar.

2.	Double-click on a subtopic to see only its tree.

Use the menu options or corresponding icons on the tool bar to move back to the previous graph, to go to contents, expand and decrease levels and set printer and font options.

3.	Control+Click on any topic name to go to that topic in the ForeHelp window.

4.	To leave the Grapher, close the window.

Reporter

The Reporter will format and print reports in columnar form displaying the field and topic information that you select.

1.	Select Tools|Reporter.

2.	Select any or all topics and fields in the Reporter Options dialog box that you would like to display and/or print.

3.	OK.

You may change fonts and printer settings using the menu options or corresponding icons on the tool bar.

4.	To leave the Reporter, close the window.


Viewing and Editing Paragraph Styles

ForeHelp includes a style-based word processor.  Styles are named groups of formats that you can apply to paragraphs for fast and consistent formatting.  Use styles for paragraphs and save local character/paragraph changes for sections of text within paragraphs.  Local changes always override style changes.

All ForeHelp databases have default styles called Base, Banner Base, Button Bar, List1, List2, and List3.  These styles may be edited to change associated formats.  You can create your own new styles or import additional styles from RTF files as we just did.

To View the Styles in a Project

1.	Select Format|Edit Style.

2.	Click the down arrow to the right of the Name box to display the drop down list box of style names.

To View or Change a Style’s Attributes

1.	Click the style name desired.

2.	Click the Character and/or Paragraph buttons to access the appropriate dialog boxes and make your changes, OK.